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Starter Repairer 


The Startup Repair ( Boot-Repair in English) is a small tool that offers: 


e a Recommended Repair button to repair most startup problems (for example when Ubuntu no 
longer starts after installing Windows, when the GRUB menu no longer appears 1 or when you 
have a GRUB rescue> or out error -of-disk); 

e asecond button to create a Boot-Info report in one click (For help via email or Forum); 

e advanced options allowing, among other things, to: 

o update the GRUB boot menu; 

o reconfigure GRUB (add kernel options, etc.); 

o purge and reinstall GRUB2; 

o restore an MBR allowing Windows to start in Legacy mode. 
o repairs recent PCs (UEFI) as well as old PCs. 


Créer un rapport Bootinfo 
(pour se faire aider par email ou Forum) 


> Options avancées 


A propos Quitter 


Boot-Repair repairs boot-only problems. Not the display ones for example. IF you don't 
know what type of problem you are having, go to the diagnostic page , and create a Boot- 
Info report to ask For help on the Forum. 


error status 4" error, look at the physical state of your disk (https://doc.ubuntu- 
fr.org/smartmontools#cas_d_un_disque_interne) and do not use boot-repair. 


Boot-repair does not know how to rebuild the internal Windows boot structure which 
must be done with the windows tools (bcdedit / rebuild) 


Q WARNING: If your computer crashes in EMERGENCY mode saying "there is an fsck type 


E IF your computer is an ACER, it is very likely that you forgot to allow UBUNTU to boot 
(https://Forum.ubuntu-fr.org/viewtopic.php?pid=21468818#p21468818) . Boot-repair will 
not do it for you. 
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1. Installation 


Several possibilities : 


1.1 Get a disk with Boot-Repair pre-installed 


For convenience, or if your broken PC does not have an internet connection, you can download a disk 
with Boot-Repair pre-installed, For example Boot-Repair-Disk (http://Fforum.ubuntu- 
Fr.org/viewtopic.php?pid=5745281#p5 745281) ( Live USB (https://Fr.wikipedia.org/wiki/Live USB) 
automatically launching Boot-Repair on startup). Create a liveUSB From this ISO image, then boot your 
computer on it. 


Warning: if your PC has Windows 8 or 10 pre-installed, and / or if it starts in EFl mode , do not burn the 


1.2 Install Boot-Repair from a live session (DVD or liveUSB) 
of Ubuntu 


IF you have a liveDVD (or a liveUSB ) From Ubuntu, and your broken PC has an internet connection, you 
can install Boot-Repair temporarily: 


e Start the computer on the Ubuntu live CD (or the liveUSB ); 
e Choose Try Ubuntu; 
e Ifyou haven't already, connect the internet and check that it works. 


ping -c5 google.com 
e Then install the software by copying / pasting the following command in a terminal: 


sudo add-apt-repository -y ppa:yannubuntu/boot-repair && sudo apt update && sudo apt insta 


> 


2. Use 


2.1 Check before launching the tool 


On a UEFI compatible PC, it is recommended to use Boot-Repair from a UEFI session as this allows a 
greater choice of repair ? . It is therefore recommended to: 


e Check that the boot on the live-CD (or live-USB or installed session) was done in the desired 
mode. 

e If necessary, reboot, choose the right parameter in the firmware , and recheck before 
proceeding. 


2.2 Start-up 


Run the Starter Repairer 


e either via the dashboard 
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e either via the command terminal by typing boot-repair 


2.3 Create a Boot-Info report 


e click on Create a Bootinfo report , then note the URL (address starting with "http:") that appears 


Fr.org/post.php?fid=10) explaining your problem. This will allow those who are helping you to 
determine whether the problem you are having is boot-related, and if so whether the 
"Recommended repair" option of Boot-Repair is suitable or not. 


2.4 Standard repair 


e click on Recommended Repair 


Réparateur de démarrage 


Réparer le démarrage de l'ordinateur 


Réparation recommandée 
(répare les problèmes les plus fréquents) 


Créer un rapport Bootinfo 
| (pour se faire aider par email ou forum) | 


> Options avancées 


[À propos | | Quitter | 


e once the repair is complete, restart, and check if you have access to your systems again 


3. Advanced use 


reinstall GRUB, repair file system, restore MBR, etc. divided into several tabs. 
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Important: The default settings are For Recommended Repair. Changing them can make your 
problem worse. Do not edit them without at least creating a Bootinfo report and asking for Feedback 
on this discussion (http://forum.ubuntu-fr.org/viewtopic.php?pid=4726141) . 


3.1 Main options 


The main options grid is displayed pre-populated with some options. 


Réparateur de démarrage 


Réparer le démarrage de l'ordinateur 


7 Options avancées 
Options principales Emplacement de GRUB Options de GRUB Options de MBR Autres options 


Sauvegarder les tables de partitions, les secteurs d'amorçage et les logs 


Réinstaller GRUB 
Utiliser le fichier EFI standard 
~) Sauvegarder et renommer les fichiers EFI Windows (résout l'erreur [hard-coded-EFI]) 


Faire apparaitre le menu de démarrage : 10 = F secondes 
_) Réparer les systèmes de fichier 
Réparer les systèmes de fichier Wubi 
À propos Quitter | | Appliquer 


e Reinstall GRUB 
This pre-populated option will reinstall a grub. Certainly the simplest action. 
e Use the standard EFI File 


This pre-populated option will transfer the ubuntu boot Files to the official EFI boot files. A number of 
computers require this option. 


e Back up and rename Windows EFI files 


This option, to be chosen after reflection, will duplicate the ubuntu boot files in the microsoft boot 
Files. Some computers need this option. 


e Unhide boot menu 
This option allows forcing the display of the GRUB menu. Some computers need this option. 
e Repair File systems 


This option will examine the partitions present in the computer and restore them to their original state. 
Use only after creating a copy of your discs. 


e Repair wubi File systems 


This option allows to repair access to some wubi files. 


3.2 'GRUB Location’ tab 
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The main options grid is displayed pre-filled with certain configurable options using the drop-down 


Boot Repair -= x 


Repair the boot of the computer 


~ Advanced options 


Main options GRUB location GRUB options Other options 


menu. 
OS to boot by default: sdb11 (Ubuntu Focal Fossa (development branch)) v 
Separate /boot partition: sda25 ~ 
Separate /boot/efi partition: sdb1 v 
About Quit | | Apply 


e The system to boot by default. IF you select a Linux, Boot-Repair will install its GRUB. IF you select 
Windows, Boot-Repair will install GRUB and set Windows as the default choice. 
e The storage partition of the boot directory 


When multiple ext4 partitions are present, boot-repair informs to check that area and choose what is 
best. As much as possible, having a separate boot partition should be avoided. IF necessary, it is better 
to choose one stored on the same disk. IF possible, the one that was initially planned For this OS 


e The storage partition of the EFI boot directory 


When multiple fat32 partitions or other partitions with the ESP Flag are present, it is best to choose 
one that is stored on the same disk. Note that partitions Formatted in EXT4 with the correct Flag can be 
selected but the installation will crash. 


IF you did not select the / boot / efi option and you have multiple disks, you will see the Following 
options: 


Réparateur de démarrage 


Réparer le démarrage de l'ordinateur 
¥ Options avancées 


Options principales Emplacement de GRUB Options de GRUB Autres options 


OS par défaut au démarrage sda1 (L'OS actuellement utilisé - Ubuntu 11.10) 


Partition /boot séparée 


Placer GRUB dans tous les disques (sauf disques USB sans OS) 


@ Placer GRUB dans sda 


Forcer GRUB dans : sda1 (pour chainloader) 


A propos Quitter) | Appliquer 


3.3 'GRUB Options' tab 


The options are displayed or not, selectable or not, depending on your system, and in particular the 
nature of the bios (EFI or LEGACY). 
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Réparer le démarrage de l'ordinateur 
v Options avancées 
Options principales Emplacement de GRUB Options de GRUB Autres options 
Purger GRUB avant de le réinstaller 
Mettre 4 niveau GRUB vers sa version la plus récente GRUB Legacy 
Effacer l'espace libre après MBR (résout l'erreur [FlexNet]) 
Décommenter GRUB_GFXMODE (résout l'erreur [no-signal / out-of-range]) 
Support disque ATA (résout l'erreur [out-of-disk]) 
Ajouter une option au noyau 
Purger les kernels puis réinstaller le dernier kernel 


] Modifier le fichier de configuration de GRUB 


A propos Quitter Appliquer 


e SecureBoot 


It is now possible not to install a secure boot. A number of computers were blocking at the time of this 
installation. It will certainly take a little hindsight to see the effectiveness of this novelty. 


e Purge GRUB before reinstalling it 


This option allows packages to be completely purged from GRUB, which is necessary in some cases. 
Causes a grid to open asking to copy some commands, open another terminal and execute them. 


The grid may look like this 


Boot Repair 


Please open a terminal then type (or copy-paste) the following commands: 
sudo chroot "/media/ubuntu/Ubu2004-SLIM-BIS" dpkg —configure -a 
sudo chroot "/media/ubuntu/Ubu2004-SLIM-BIS" dpkg -configure -a 
sudo chroot "/media/ubuntu/Ubu2004-SLIM-BIS" apt-get install -fy 
sudo chroot "/media/ubuntu/Ubu2004-SLIM-BIS" apt-get install -y lvm2 
sudo chroot "/media/ubuntu/Ubu2004-SLIM-BIS" apt-get purge -y grub*-common shim-signed 


Cancel Forward 


Or to that 
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Boot Repair - 


Please open a terminal then type (or copy-paste) the Following commands: 
"/mnt/boot-sav/sdb11" dpkg -configure -a 

"/mnt/boot-sav/sdb11" dpkg -configure -a 

"/mnt/boot-sav/sdb11" apt-get install -f 

"/mnt/boot-sav/sdb11" apt-get install -y mdadm 


"/mnt/boot-sav/sdb11" mdadm -assemble -scan 
"/mnt/boot-sav/sdb11" 
"/mnt/boot-sav/sdb11" 
"/mnt/boot-sav/sdb11" 
"/mnt/boot-sav/sdb11" 


If a window similar to the one below appears, use Tab and Enter keys in order to confirm GRUB removal. 


Configuring grub-pc 
Do you want to have all GRUB 2 files removed from /boot/grub? 


Your system would be then unbootable if you don't install another 
boot loader. 


Remove GRUB 2 from /boot/grub? 


Cancel Forward 


Depending on the state of your system, some commands may generate errors. It doesn't have to be 
awkward at this point. 


After confirming the deletion, a new grid is displayed and asks to copy an command and execute it in 
the already open terminal. 


Boot Repair - 


Now please type (or copy-paste) the following command in a terminal: 
sudo chroot “/media/ubuntu/Ubu2004-SLIM-BIS" apt-get install -y grub-efi-amdó4-signed shim-signed linux-headers-generic 


Discard Forward 


It is completely possible to add options (-no-nvram) to this command. It is also possible to execute 
additional commands. This is probably the end of repairs in chroot mode. 


e Upgrade GRUB to its most recent version 


Si sélection de cette option, un message d'avertissement apparaît. "Warning: this will install necessary 
packages from Ubuntu-20.10 repositories. Please backup your data before this operation. 


e Reset extra space after MBR 


This option is obviously not available in EFI mode. It is intended to eliminate ‘pirate’ boots which are 
installed in a non-standard way. 


e Uncomment GRUB_GFXMODE 
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Force the display resolution of the OS boot choice File to 640x480. Required to view GRUB on some 
systems. 


¢ ATA disk support 
e Adda kernel option 


Allows you to add predefined options in the drop-down list in the grub boot. 


It is possible to add an option not provided in this list, via the button 'Modify the configuration file of 
GRUB' which is at the bottom of the tab. 


¢ Purge kernels and reinstall last kernel 


Checked by default in certain situations. Allows you to reinstall the latest ubuntu kernel by First 
removing all existing kernels in the selected UBUNTU. It can be used when starting the grub crashes in 


deactivate it as a First step. 


Use when the contents of the / boot directory appear to be incorrect. Also usable if this directory no 
longer exists. It will then be remanufactured. 


Note that this option will ask you to execute a batch of commands in a terminal to do the purification 
then another to install the software then it will continue on the generation of the /boot/grub/grub.cfg 
File . 


Should also work if by accident all kernels were deleted. 
NOTE: The only options that can be added to the kernel are: 


e nomodeset 

e acpi=off 

e acpi_osi= 

e edd=on 

e i815modeset = 1 

e i915modeset=0 

e i915modeset=0 xforcevesa 

e noapic 

e nodmraid 

e nolapic 

e nomodeset radeon mode = 0 
* nomodeset radeon mode = 1 
e rootdelay=90 

e vga=771 

e xforcevesa 


3.4 'MBR options’ for non EFI boot (Legacy) 


This tab is inaccessible if you have checked the / boot / efi option. 


Restoring a Windows MBR (to start directly on Windows) or on another system: 
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Réparateur de démarrage 


Réparer le démarrage de l'ordinateur 
v Options avancées 


Options principales Options de MBR Autres options 


Restaurer le MBR de sda (mbr) X 


Partition démarrée par le MBR: sda1 (Ubuntu 12.04 LTS) + 


Apropos Quitter Appliquer 


boot flag. 

e generic altmbr: Allows you to select the boot partition by imposing the partition number instead 
of the Flag. 

e generic gptmbr: Allows you to select the boot partition by searching For the one that has an ESP 
boot Flag. 


() and allows you to choose the one to be placed in the MBR. It is preferable to choose one present in 
the selected disc. 


3.5 Various options 


The various options grid is displayed with all the options validated. They can all be invalidated. 
Boot Repair = x 


Repair the boot of the computer 


+ Advanced options 


Main options GRUB location GRUB options Other options 


Repair Windows boot files 


Create a Bootinfo summary (to get help by email or forum) 
Upload the report to a pastebin 

Participate to statistics of use 

Check internet connection 


About Quit Apply 


e Repair windows boot-files 

This action is useful for some Windows systems, and has no effect on others. 
e Create a boot-info summary 

Create a boot-info report Following the repair. 


e Upload the report to a pastbin 
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It is also possible to copy / paste what is displayed on the screen directly in the ubuntu discussion as 
long as you do not forget to do the formatting. 


e Participe to statistics of use 
e chech internet connection 


Uncheck if you have ever connected to the internet but Boot-Repair does not detect it. 


4.CLI options 


The complete and up-to-date list of options available on the command lines is obtained by entering the 
command: 


man boot-repair 


For example, it is possible to create a boot-info report without going through the graphical interface. 


5. Uninstallation 


To remove this application, just remove the boot-repair package . IF you often use Boot-Repair on an 
installed session, you can delete the log / var / log / boot-repair Folder in administrator mode. 


6. See as well 


e (en) Official site (https://sourceforge.net/p/boot-repair/home/Fr) 

e (en) Discussion "Boot-Repair: Repair PC startup (GRUB, MBR) in 1 click!" (http://forum.ubuntu- 
Fr.org/viewtopic.php?pid=4726141)on the Ubuntu-fr forum: for any comments / questions, etc. 

e Replacing Grub by refind with the help of Boot-Repair: remplacer_grub_par_refind 

e How to install grub-efi in command lines: grub-efi 


Main contributors: YannUbuntu 


1) For example if a Windows software has written in the MBR (https://bugs.launchpad.net/bugs/441941) 
2) if you ask Boot-Repair to repair a UEFI boot from a Legacy session, it will ask you to restart Boot- 
Repair from a UEFI session. 
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